WriteAxisAlias

將別名索引寫入軸。別名索引可讓布纜在無法與程式吻合時，重新排列軸的清單。

語法

KsError WriteAxisAlias(
     int Index,
     int Alias
);

參數

Index：軸的索引。索引以 0 為起始；別名將影響此參數。

Alias：欲取代軸索引所使用的別名索引。索引以 0 為起始。

回傳值

若此函式執行成功，會回傳 errNoError，否則會傳回錯誤碼。如需更多有關錯誤碼的資訊，請參閱 KsError 清單。

備註

• 重新排列軸。在 KINGSTAR 子系統啟用後使用。
• 別名索引可在軸的實際索引範圍之外。

可用的 EtherCAT 狀態

ecatOP

範例

#define AxisX 101
#define AxisZ 102
#define AxisC 103

// Apply the aliases
nRet = WriteAxisAlias(1, AxisX);
nRet = WriteAxisAlias(2, AxisZ);
nRet = WriteAxisAlias(0, AxisC);
nRet = EnableAliases(TRUE);

使用需求

參見

EnableAliases

GetAliasesStatus

ReadAxisAlias